CONVERSION


The TO action has the capability to convert the selected characters to decimal or hexadecimal numbers, and decimal or hexadecimal numbers to their corresponding ASCII characters.
This can be achieved with the use of converter keywords surrounded by asterisks (*) that can be given as an argument to TO.
Those converters are:

CHR : Converts selected numeric data to ASCII characters.
[:]HEX[<n>] : Converts characters or decimal numbers to hexadecimal numbers.
[:]DEC[<n>] : Converts characters or hexadecimal numbers to decimal numbers.

HEX and DEC can be followed by a number to indicate the number of formatting digits that the resulting numbers will have.
HEX and DEC can also be preceded by a colon (:) to indicate that even selected numeric data will be treated as ASCII characters.
Any characters outside the asterisks are placed next to the result of the conversion.

Examples:

SRename filename TO %*hex* : Convert the filename to hex byte values.
Output:
"filename" renamed as "%66%69%6C%65%6E%61%6D%65"

SRename filename MT name TO %*hex* : Convert "name" to hex byte values.
Output:
"filename" renamed as "file%6E%61%6D%65"

SRename filename TO +*dec* : Convert the filename to decimal byte values.
Output:
"filename" renamed as "+102+105+108+101+110+97+109+101"

SRename filename TO +*dec3* : As above but all numbers are 3-digit.
Output:
"filename" renamed as "+102+105+108+101+110+097+109+101"

SRename "%66%69%6C%65%6E%61%6D%65" MATCH %/hex/ TO *chr* : Convert the byte hex values to their corresponding characters.
Output:
"%66%69%6C%65%6E%61%6D%65" renamed as "filename"


To perform numeric conversion tasks MATCH and TO must be used together. MATCH is required to search for and select the numeric data in the filename that will be converted.

Examples:

MATCH /dec/ TO *hex* : Convert every decimal character found to a hexadecimal.

MATCH +/dec/ TO *hex* : Convert every decimal character found that starts with "+" to a hexadecimal. The "+" character is discarded.

MATCH +/[dec]/ TO *hex* : As above but the "+" is retained because only the decimal number was selected by the "[" and "]" selection designators.

MATCH +/dec/d TO %*hex* : Convert every decimal character that starts with "+" and ends with "d" to hexadecimal numbers with "%" in front of them. The "+" and "d" characters of the decimal numbers are discarded.

MATCH +/dec/ TO %*hex* : The "+" character is discarded and a "%" character is put in front of the resulting hexadecimal numbers.

MATCH +/[dec]/ TO %*hex* : The resulting hexadecimal numbers have both the characters "+%" in front of them.

MATCH /dec/ TO %*:hex2* : Convert the characters of decimal numbers to hexadecimal byte values that start with "%" and are 2-digit. Note that this is different from using "MATCH /dec/ TO %*hex2*" because in this example a colon is placed before "hex2" and each digit that makes up the decimal number is converted to a hexadecimal byte value and not the entire decimal number as would happen with the latter statement. 

The conversion capability can be handy when you come across filenames that contain hexadecimal values in them like for example:

"12a%3c1%3e.jpg" is "12a<1>.jpg"
"AnnaKournikova%28Karembeu%29.jpg" is "AnnaKournikova(Karembeu).jpg"

To get the real filenames you would simply use:
MATCH %/hex2/ TO *chr*